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(57) ABSTRACT 

A method, apparatus, and article of manufacture for a filter 
table list utility. Information is displayed on a monitor 
attached to a computer. An open database window is dis- 
played in which search criteria is entered for searching for 
tables. A search is performed for tables using the entered 
search criteria, prior to retrieving names of all of the tables 
to display on the monitor. When tables are found that meet 
the search criteria, a list of the found tables is generated for 
displaying on the monitor. The generated list is displayed on 
the monitor. 

12 Claims, 6 Drawing Sheets 
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METHOD AND APPARATUS FOR 
FILTERING A TABLE LIST BEFORE 
OPENING WITH A GRAPHICAL USER 
INTERFACE 

BACKGROUND OF THE INVENTION 

1. Field of the Invention 

The present invention relates generally to graphical user 
interfaces, and in particular, to a method, apparatus, and 
article of manufacture for filtering a table list before opening 
with a graphical user interface. 

2. Description of the Related Art 

Graphical user interfaces (GUIs) have greatly enhanced 
the usability and productivity of computer software. In most 
GUIs, such as found in operating systems such as Microsoft 
Windows (3.x, 95, and NT), IBM OS/2, Apple Macintosh, 
and some versions of the UNIX operating system, data is 
supplied to a user through one or more windows or views. 

In conventional systems, a GUI is displayed that enables 
a user to open a table of a database. Databases are comput- 
erized information storage and retrieval systems. A Rela- 
tional Database Management System (RDBMS) is a data- 
base management system (DBMS) which uses relational 
techniques for storing and retrieving data. Relational data- 
bases are organized into tables which consist of rows and 
columns of data. The rows are formally called tuples. A 
database will typically have many tables and each table will 
typically have multiple tuples and multiple columns. The 
tables are typically stored on direct access storage devices 
(DASD) such as magnetic or optical disk drives for semi- 
permanent storage. 

RDBMS software using a Structured Query Language 
(SQL) interface is well known in the art. The SQL interface 
has evolved into a standard language for RDBMS software 
and has been adopted as such by both the American National 
Standards Institute (ANSI) and the International Standards 
Organization (ISO). The SQL interface allows users to 
formulate relational operations on the tables either 
interactively, in batch files, or embedded in host languages, 
such as C and COBOL. SQL allows the user to manipulate 
the data. 

In a conventional system, when a user wants to open a 
table in a database, a GUI that includes a window is 
displayed for the user. The window typically includes a 
File|Open menu and/or a Browse command. Upon selection 
of the FilejOpen menu, an Open Database window is dis- 
played that includes the list of databases, a "Look in" 
dropdown list box for selecting a server to be searched, a 
"File name" edit box for selecting a database from which 
tables are to be retrieved, and a "Files of type" dropdown list 
box for specifying a file type (i.e., the file type could be 
"IBM DB2 (*)" or "all file types"). When the Open Database 
window appears, the user selects the "Files of type" drop- 
down list box to select a file type. For example, to select a 
DB2 table, the user selects an "IBM DB2 (*)" file type. At 
this point the IBM DB2 Open Database Connectivity 
("ODBC") login window appears and the user logs in. 

Once logged in, the Open Database window reappears 
with the name of the connection (e.g., userid@DB2 ). The 
user selects the connection and is presented with a list of 
databases or schema from which to select. The user selects 
a database or schema and is presented with a list of tables. 
In a conventional system, displaying the tables for databases 
which contain a large number of tables takes a long time. 
Also, since the list is potentially very large, the user may 
have a difficult time finding the desired table. 
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In some current systems, a user can enter a database 
search that will limit the tables that are displayed. However, 
these systems will retrieve all tables, which is time 
consuming, and then search for the requested tables, 
s Consequently, a significant need exists for a utility that 
allows a user to filter table lists more efficiently. 

SUMMARY OF THE INVENTION 

To address the requirements described above, the present 
10 invention discloses a method, apparatus, and article of 
manufacture for a filter table list utility. According to the 
present invention, information is displayed on a monitor 
attached to a computer. An open database window is dis- 
played in which search criteria is entered for searching for 
15 tables. A search is performed for tables using the entered 
search criteria, prior to retrieving names of all of the tables 
to display on the monitor. When tables are found that meet 
the search criteria, a list of the found tables is generated for 
displaying on the monitor. The generated list is displayed on 
20 the monitor. 

BRIEF DESCRIPTION OF THE DRAWINGS 

Referring now to the drawings in which like reference 
25 numbers represent corresponding parts throughout: 

FIG. 1 is an exemplary hardware environment used to 
implement the preferred embodiment of the invention; 

FIGS. 2A-2B illustrate graphical user interfaces (GUIs) 
displayed on a monitor according to the present invention; 
30 FIG. 3 is a flowchart that illustrates the general logic of a 
message or event-driven operating system performing the 
steps of the present invention; 

FIG. 4 is a flowchart that illustrates the general logic for 
a routine 400 that is performed by the Filter Table List utility 
35 to process an 'Open'; and 

FIG. 5 is a flowchart that illustrates the general logic for 
a routine 500 that is performed by the Filter Table List utility 
to process a double -clicked database or schema. 

40 DETAILED DESCRIPTION OF THE 

PREFERRED EMBODIMENTS 

In the following description, reference is made to the 
accompanying drawings which form a part hereof, and 
45 which is shown, by way of illustration, several embodiments 
of the present invention. It is understood that other embodi- 
ments may be utilized and structural changes may be made 
without departing from the scope of the present invention. 

5Q Hardware Environment 

FIG. 1 is an exemplary hardware environment used to 
implement the preferred embodiment of the invention. The 
present invention is typically implemented using a personal 
computer 100, which generally includes, inter alia, a 

55 processor, random access memory (RAM), read only 
memory (ROM), a video card, bus interface, and/or other 
components. It is envisioned that attached to the personal 
computer 100 may be a monitor 102 (e.g., a CRT, an LCD 
display, or other display device), data storage devices 104 

60 such as hard, floppy, and/or CD-ROM disk drives, and 
peripherals, such as a printer 106. Also included in the 
preferred embodiment may be input devices, for example, a 
mouse pointing device 108 and a keyboard 110. Those 
skilled in the art will recognize that any combination of the 

65 above components, or any number of different components, 
peripherals, and other devices, may be used with the com- 
puter 100. 
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The personal computer 100 operates under the control of 
an operating system 112, which is represented in FIG. 1 by 
the screen displayed on the monitor 102. The present inven- 
tion is usually implemented in one or more computer 
programs 114 that operate under the control of the operating 
system 112, which programs 114 are represented in FIG. 1 
by the windows displayed within the screen on the monitor 
102. However, it should be understood that, in the 
alternative, the principles of the invention may also apply to 
specific utilities or functions within the operating system 112 
itself. In general, the functions performed in the present 
invention, whether implemented as part of an operating 
system or a specific application, will be referred to herein as 
"computer programs". 

Generally, the computer programs which implement the 
preferred embodiment of the invention are embodied in or 
readable from a computer-readable device, medium, or 
carrier, e.g., one or more of the fixed and/or removable data 
storage data devices 104 and/or remote devices coupled to 
the computer 100 via data communications devices con- 
nected to the computer 100. Under control of operating 
system 112, the computer programs 114 may be retrieved 
from the data storage devices or remote devices into the 
memory of computer 100. The computer programs comprise 
instructions which, when read and executed by computer 
100, cause the computer 100 to perform the steps necessary 
to execute the steps or elements of the present invention. 

Thus, the present invention may be implemented as a 
method, apparatus, or article of manufacture using standard 
programming and/or engineering techniques to produce 
software, firmware, hardware, or any combination thereof. 
The term "article of manufacture" (or alternatively, "com- 
puter program product") as used herein is intended to 
encompass a computer program accessible from any 
computer-readable device, carrier, or media. Of course, 
those skilled in the art will recognize many modifications 
may be made to this configuration without departing from 
the scope of the present invention. 

Those skilled in the art will recognize that the exemplary 
environment illustrated in FIG, 1 is not intended to limit the 
present invention. Indeed, those skilled in the art will 
recognize that other alternative hardware environments may 
be used without departing from the scope of the present 
invention. 

Filter Table List 

The present invention is a Filter Table List utility or 
computer program that comprises a dockable window (mini- 
frame window) that enables a user to filter a list of tables 
prior to the list of all of the tables being retrieved from a 
database. The Filter Table List utility provides the capability 
for a user to specify a search criteria in the Open Database 
window at the point where the list of databases or schema 
are displayed. The Filter Table list utility is typically used 
with SQL back-ends, and, considering that power users are 
most likely to run into the problem of receiving large table 
lists, the Filter Table List utility is especially advantageous 
for them. 

In the preferred embodiment, the Filter Table List utility 
enables a user to specify a search criteria within the "File 
name" edit box of the Open Database window. The filter 
table list uses this search criteria to search a database or 
schema for tables that match the search criteria before 
retrieving the list of tables that are in that database or 
schema. The search criteria indicates a characteristic of the 
tables, for example, a name or a portion of a name. 
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Standard GUI mechanisms are preferably implemented to 
permit the display characteristics of the Open Database 
window to be modified in much the same manner as any 
window. It should be appreciated that these functions are 
standard in many GUI environments, and well understood 
by those of ordinary skill in the art. Implementation of these 
mechanisms is well known in art, and include such functions 
as minimizing, maximizing, closing, opening, resizing, 
repositioning, etc., the Open Database window. 

The Filter Table List utility is automatically invoked by 
the user entering search criteria. In the present embodiment, 
the filter table list is invoked within the APPROACH® 
application program sold by Lotus Development 
Corporation, a wholly-owned subsidiary of IBM 
Corporation, the assignee of the present invention. The 
APPROACH® application program is a database manage- 
ment system (DBMS) often purchased as part of the 
LOTUS® SMARTSUITE® oflSce productivity package. Of 
course, those skilled in the art will recognize that the Filter 
Table List utility could be used with other products as well. 

FIGS. 2A-2B illustrate graphical user interfaces (GUIs) 
displayed on a monitor according to the present invention. 
As illustrated in FIG. 2 A, the GUI is an Open Database 
window 200 that includes a "Look in" dropdown list box 
202, a list of databases or schema 204, a "File name" edit 
box 206, a "Files of type" dropdown list box 208, and a 
"Description" text box 210. A user specifies a server, which 
has been connected, using the "Look in" dropdown list box 
202. A user can select a database or schema from the list of 
databases 204. A user can specify a database or schema to be 
30 searched for tables by entering a name in the "File name" 
edit box 206. A user can select the type of databases to be 
connected by entering a file type in the "Files of type" 
dropdown list box 208. Additionally, the user can view 
instructions for using the GUI by viewing the "Description" 
text box 210. 

FIGS. 2A-2B are snapshots of the Open Database win- 
dow 200 after the user has selected a connection and logged 
in. The user then views the list of databases or schema 204 
to which the user has access. At this point, if the user double 
clicks on a database or schema name, the user will see a list 
40 of all of the tables in that database or schema. Similarly, if 
the user enters the name of the database in the "File name" 
edit box and selects the "Enter" key or clicks on the "Open" 
button, the user will see a list of all of the tables in that 
database. 

45 The filter table list, however, enables a user to filter the list 
of tables prior to the list of tables being displayed in the GUI. 
In particular, the user can enter the name of the database or 
schema followed by a separator, such as a dot (V) 206, as 
illustrated in FIG. 2A, or a backslash ('V) 212, as illustrated 
in FIG. 2B, and then enter a search criteria. The user can also 
select a database or schema 204 and enter a search criteria 
206. Then, the filter table utility searches for all of the tables 
that match the search criteria entered before retrieving the 
list of tables. The filter table list is advantageous in that the 
filter table list avoids retrieving unnecessary tables from the 
list. By filtering the list of tables prior to retrieval, the Filter 
Table List utility saves time and other resources. The dot 
notation (e.g., database. table) and the backslash notation are 
common in SQL, which enables users who are familiar with 
SQL to be especially comfortable entering the search crite- 
ria. For a file name without a dot or a backslash notation, if 
a database or schema is selected or double clicked, the file 
name is a table search criteria, otherwise, the file name is a 
database or schema to be opened. 

65 Flowcharts 

FIG. 3 is a flowchart that illustrates the general logic of a 
message or event-driven operating system 112 performing 
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the steps of the present invention. In such a system 112, represents the computer 100 determining whether a file 

operations are performed when transitions are made, based name was entered. Block 506 represents the computer 100 

upon the receipt of messages or events, from present or performing the retrieve function for filtering a table list on 

current states to new states. the double clicked database or schema. Block 508 represents 

Generally, routine 300 begins by waiting at block 302 for 5 the computer 100 performing the retrieve function for all 

an event (e.g., a mouse button click). It should be appreci- tables on the double clicked database or schema. Block 510 

ated that during this time, other operating system 112 tasks, represents the computer 100 displaying an open database 

e.g., file, memory, and video tasks, etc., may also be carried table ^ window. 

out. When an event occurs, control passes to block 304 to Of course, those skilled in the art will recognize that the 

identify the event Based upon the event, as well as the 10 use of any mouse button, keyboard sequence, voice 

current state of the system 112 determined in block 306, a command, or other user input is merely a design choice, and 

new state is determined in block 308. In block 310, the the functions performed by the Filter Table List utility could 

routine 300 transitions to the new state and performs any be invoked by any number of different combinations of 

actions required for the transition. In block 312, the current mouse buttons, keyboard sequences, voice command, or any 

state is set to the previously determined new state, and 35 other user input, 

control returns to block 302 to wait for more input events. Conclusion 

The specific operations that are performed by block 310 

when transitioning between states will vary depending upon Tn* concludes the description of the preferred embodi- 

the current state and the event. The various operations ment of lhe invention. The following describes some alter- 

required to implement and maintain the Navigator of the 20 native embodiments for accomplishing the present inven- 

present invention represent particular events handled by tlon - 

routine 300. However, it should be appreciated that these For example, any type of computer, such as a mainframe, 

operations represent merely a subset of all of the events minicomputer, work station, personal computer, or network 

handled by any operating system 112. computer could be used with the present invention. In 

FIG. 4 is a flowchart that illustrates the general logic for 25 addition, any software program, application or operating 

a routine 400 that is performed by the Filter Table List utility svstem havin S a graphical user interface could benefit from 

to process an 'Open'. Generally, routine 400 begins by the P resent mveDtl0D - 

waiting at Block 402 for an event (e.g., a mouse button click In summary, the present invention discloses a method, 

signifying selection of a menu item). When an event occurs, apparatus, and program storage device for displaying open 

control passes to blocks 404-418 to identify the events and database window in which search criteria is entered for 

perform associated functions. Block 404 represents the searching for tables in a database or schema, A search is 

computer 100 determining whether a file name was entered. performed for tables in the database or schema using the 

If a file name was entered, control passes to Block 406, entered search criteria, prior to retrieving names of all of the 

otherwise, control passes to Block 412. Block 406 represents „ tables in the database or schema to display on the monitor, 

the computer 100 determining whether the file name con- When tables are found that meet the search criteria, a list of 

tained a backslash or a dot. If the file name contains a the found tables is retrieved for displaying on the monitor, 

backslash or a dot, control passes to Block 408, otherwise, The retrieved list is displayed on the monitor, 

control passes to Block 410. Block 408 represents the The foregoing description of the preferred embodiment of 

computer 100 performing the retrieve function for filtering 4Q the invention has been presented for the purposes of illus- 

a table list on the entered or selected database or schema tration and description. It is not intended to be exhaustive or 

name, which is specified before a backslash or dot of the file to limit the invention to the precise form disclosed. Many 

names or of the selected database or schema. Block 410 modifications and variations are possible in light of the 

represents the computer 100 determining whether any data- above teaching. It is intended that the scope of the invention 

base or schema has been selected. If a database or schema 45 be limited not by this detailed description, but rather by the 

has been selected, control passes to Block 408, otherwise, claims appended hereto, 

control passes to Block 414. What is claimed is: 

Block 412 represents the computer 100 determining 1. A method operable in a relational database management 
whether any database or schema has been selected. If a system which accesses a database to retrieve names of tables 
database or schema has been selected, control passes to 50 therein, visually displays the database table names in a 
Block 414, otherwise, control passes to Block 416. Block dialog box and opens a database table based on a database 
414 represents the computer 100 performing the retrieve la ^ le name entered into the dialog box, the method corn- 
function for all tables on the entered or selected database or prising: 

schema name. Block 416 represents the computer 100 (a) determining if the information entered into the dialog 

displaying an error message that states "Enter Table Search 55 box includes user-defined search criteria in addition to 

Criteria in 'File Name' Edit Box before Clicking 'Open 5 the database table name; 

button; or Double Click a Database or Schema to Open." (b) using a filter utility program located in the database 

Block 418 represents the computer 100 displaying an open management system to retrieve names of tables in the 

database table list window. database that satisfy the search criteria when the infor- 

FIG. 5 is a flowchart that illustrates the general logic for 60 m ation entered into the dialog box includes user- 

a routine 500 that is performed by the Filter Table List utility defined search criteria; 

to process a selected database or schema (e.g., the database (c) using the database management system to retrieve 

or schema has been double -clicked). Generally, routine 500 names of all tables in the database when the informa- 

begins by waiting at Block 502 for an event (e.g., a mouse tion entered into the dialog box does not include 

button click signifying selection of a menu item). When an 65 user-defined search criteria; and 

event occurs, control passes to blocks 504-510 to identify (d) displaying the retrieved database table names in the 

the events and perform associated functions. Block 504 dialog box. 
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2. The method of claim 1 wherein step (a) further com- 
prises the step of: 

(a.l) determining if the search criteria contains a demar- 
cation character preceding the database table name. 

3. The method of claim 2 wherein the demarcation 
character comprises a backslash. 

4. The method of claim 2 wherein the demarcation 
character comprises a dot. 

5. A computer program product operable in a relational 
database management system which accesses a database to 
retrieve names of tables therein, visually displays the data- 
base table names in a dialog box and opens a database table 
based on a database table name entered into the dialog box, 
the computer program product comprising a computer 
usable medium having computer readable program code 
thereon, including: 

(a) program code configured to determine if the informa- 
tion entered into the dialog box includes user-defined 
search criteria in addition to the database table name; 

(b) filter utility program code that is loadable into the 
database management system and which is configured 
to retrieve names of tables in the database that satisfy 
the search criteria when the information entered into 
the dialog box includes user-defined search criteria; 

(c) program code that is configured to use the database 
management system to retrieve names of all tables in 
the database when the information entered into the 
dialog box does not include user-defined search crite- 
ria; and 

(d) program code that is configured to display the 
retrieved database table names in the dialog box. 

6. The computer program product of claim 5 wherein the 
program code configured to determine if the information 
entered contains search criteria further comprises the pro- 
gram code configured to determine if the search criteria 
contains a demarcation character preceding the database 
table name. 



7. The method of claim 6 wherein the demarcation 
character comprises a backslash. 

8. The method of claim 6 wherein the demarcation 
character comprises a dot. 

9. Apparatus operable in a computer system having a 
memory, a display and a relational database management 
system which accesses a database to retrieve names of tables 
therein, visually displays the database table names in a 
dialog box and opens a database table based on a database 
table name entered into the dialog box, the apparatus com- 
prising: 

(a) program logic configured to determine if the informa- 
tion entered into the dialog box includes user-defined 
search criteria in addition to the database table name; 

(b) filter utility program logic located in the database 
management system configured to retrieve names of 
tables in the database that satisfy the search criteria 
when the information entered into the dialog box 
includes user-defined search criteria; 

(c) program logic configured to use the database manage- 
ment system to retrieve names of all tables in the 
database when the information entered into the dialog 
box does not include user-defined search criteria; and 

(d) program logic configured to display the retrieved 
database table names in the dialog box. 

10. The apparatus of claim 9 wherein the program logic 
configured to determine if the information entered contains 

30 search criteria further comprises program logic configured to 
determine if the search criteria contains a demarcation 
character preceding the database table name. 

11. The apparatus of claim 10 wherein the demarcation 
character comprises a backslash. 

12. The apparatus of claim 10 wherein the demarcation 
character comprises a dot. 
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